Shareware Grab Bag

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Grab Bag / Shareware Grab Bag.iso / 050 / tsw.arc / SW.DOC < prev next >

Wrap

Text File | 1986-01-01 | 55.6 KB | 2,706 lines

PLEASE NOTE: This manual is formatted for 5 1/2" by 8 1/2" paper. I chose this formatting so that the manual could be easily placed into a three-ring binder similar to those supplied with your personal computer. Simply cut the pages along the marks provided on each page ("|","+" and "-") and punch your own holes. Of course, you will probably want to discard this page. ------------------------------------------ | *************************************** * * * T U R B O S C R E E N W O R K S * * * *************************************** by Chris Lindberg ------------------------------------------ Copyright(C) 1986 Chris Lindberg - + ------------------------------------------ | ------------------------------------------ Copyright(C) 1986 Chris Lindberg - + | SOFTWARE LICENSE AND COPYRIGHT This software product is copyrighted and all rights reserved by Chris Lindberg. TURBO SCREENWORKS is being distributed using a modified version of the FREEWARE plan. The demonstration version of TURBO SCREENWORKS is fully functional except that only two (2) screen images can be incorporated into a collate file at a time. If you find TURBO SCREENWORKS to be of value and wish to own a fully functional version, please fill out the registration form on the following page and send it along with $25.00 to: Chris Lindberg 5221 W. Washington Blvd. Milwaukee, WI 53208 Upon receipt of the registration form and $25.00, I will supply you with a fully functional version of TURBO SCREENWORKS registered under your name. You are encouraged to circulate the demonstration version of TURBO SCREENWORKS freely among Turbo Pascal enthusiasts. Turbo Pascal is a trademark of Borland International, Inc. - + | TURBO SCREENWORKS OWNER REGISTRATION ------------------------------------------- In order to receive a fully functional and registered version of TURBO SCREENWORKS, please fill out the order form below and return it with $25.00 to: Chris Lindberg 5221 W. Washington Blvd. Milwaukee, WI 53208 NOTE: Your copy of TURBO SCREENWORKS will be registered to the name supplied below. Name ___________________________________ Address_________________________________ _________________________________ _________________________________ Where did you obtain a copy of the demonstration version of TURBO SCREENWORKS? __________________________________________ Comments _________________________________ __________________________________________ __________________________________________ __________________________________________ - + | - + | TABLE OF CONTENTS ----------------------------------------- INTRODUCTION...........................1 THE PROCESS............................2 SCREEN IMAGES..........................4 DEMONSTRATION OF TURBO SCREENWORKS...............5 MAIN - EDIT............................9 MAIN - FILE...........................15 MAIN - COLLATE........................19 MAIN - HELP...........................23 MAIN - NEW............................24 MAIN - QUIT...........................25 USING FILLSCREEN......................26 QUICK EDIT KEY GUIDE..................32 - + TURBO SCREENWORKS ------------------------------------------- | INTRODUCTION TURBO SCREENWORKS is a tool that was developed for the Turbo Pascal enthusiast. It was designed to minimize the effort required to design and manage screens that are used in your pascal programs. The screens you design and manage with TURBO SCREENWORKS can be used for data entry, data display or anything else your program requires. Simply put, TURBO SCREENWORKS relieves you of the tedium of screen design and management and provides you with a simple means for the rapid and professional display of screens throughout your pascal program. ------------------------------------------- -1- - + TURBO SCREENWORKS ------------------------------------------- | THE PROCESS Screen development can be broken down into three simple processes: 1. Screen planning 2. Screen development 3. Screen collation When developing an application, the design and use of screen images is an essential ingredient in the success of a program. After all, it represents the interface between your program and the user. The images that appear on the display should have purpose, be easy to understand and pleasing to the eye. Therefore, an important part in the design of any sizable application is the design and actual layout of screen images. The best tools for planning are undoubtedly pencil and paper. Once the application has been planned and and you know what screen images are to appear when and where, their actual development can begin. Screen image development with TURBO SCREENWORKS is simple because it places the full keyboard at your disposal for developing and editing screen images. With TURBO SCREENWORKS, you can work on screen images at the character, block or full screen level. As each screen image is completed, you save it to disk and move on to the next. Once all of the screen images have been developed, they must all be gathered into one data file using the collate process. Collation is easy and involves simply the ------------------------------------------- -2- + TURBO SCREENWORKS ------------------------------------------- | sequential addition of each screen image to a collate file. Once the process has been completed, you are then ready to begin using the FILLSCREEN procedure in your source code to display or overlay the screen images created in step 2. Since the screen images are all contained within a disk file, the speed at which a screen image is transferred to the display is heavily dependant upon disk I/O speed. Obviously, screen images will be transferred faster with systems using a hard disk. However, the advantage to using a disk for the storage of screen images is that you can create as many different screen images and overlays as you wish and not worry about memory consumption. ------------------------------------------- -3- + TURBO SCREENWORKS ------------------------------------------- | SCREEN IMAGES Before discussing how to use TURBO SCREENWORKS to develop screen images, it might be best to first define just what a screen image is, and what it can be. In simple terms, a screen image is an image that appears on the display unit attached to the system unit. Far more importantly, however, is that it also acts as the interface between the user and your program. A screen image can occupy the entire display of 25 lines and 80 columns or just a portion of it. Also, it can appear all by itself or "on top of" the image previously displayed. When an image appears "on top of" another image, it is referred to as an overlay. Used correctly, overlays can have the appearance of windows. For example, the help screens that appear upon request in TURBO SCREENWORKS were designed and implemented using TURBO SCREENWORKS. While not a "true" windowing system, TURBO SCREENWORKS can be used produce window effects that add elements of professionalism and ease of use to your pascal programs with very little programming effort on your part. ------------------------------------------- -4- + TURBO SCREENWORKS ------------------------------------------- | A DEMONSTRATION OF TURBO SCREENWORKS A demonstration program, source code and data files have been provided to show you what TURBO SCREENWORKS can do, and HOW to do it using the FILLSCREEN procedure. Below is a list of the files provided that make up the demonstration program. DEMO.COM - Compiled demonstration program DEMO.PAS - The source code for above DEMO.SDT - The collate file required for for DEMO.COM DEMO1.DTP - | DEMO1.DTA - | DEMO2.DTP - | Individual screen images DEMO2.DTA - | contained in the collate DEMO3.DTP - |-- files listed above for DEMO3.DTA - | DEMO.COM DEMO4.DTP - | DEMO4.DTA - | DEMO5.DTP - | DEMO6.DTA - | Use the following instructions to run the demonstration program provided: 1. Make sure the files, DEMO.COM and DEMO.SDT reside in the default directory. 2. Type "DEMO" next to the DOS prompt and press enter. After you have run the demonstration program, use TURBO SCREENWORKS to examine the individual screen image files to see how overlays are created and used. A ------------------------------------------- -5- + TURBO SCREENWORKS ------------------------------------------- | listing of the screen image files used to create the demonstration collate files can be obtained by using the FILE-DIR commands. To load one of the files, use the FILE-LOAD command. You can also examine the collate file that contains all of the individual screen images by opening the collate file called 'DEMO'. To open the file, use the COLLATE- OPEN command. To preview its contents, use the COLLATE-PREVIEW command. If you wish to experiment with or alter the 'DEMO' screen files provided and NOT alter DEMO.PAS, you will have to erase 'DEMO.STP' and 'DEMO.STD' before collating the individual screen files into a collate file named 'DEMO.' The individual screen image files must be collated in the following order: DEMO1 DEMO2 DEMO3 DEMO4 DEMO5 If you wish to create some new screen images and add them to the 'DEMO' collate file using the COLATE-ADD command, you will have to alter DEMO.PAS to utilize the new screen images you have added to the collate file. ------------------------------------------- -6- + TURBO SCREENWORKS ------------------------------------------- | USING TURBO SCREENWORKS TURBO SCREENWORKS uses a pop-up menu- oriented system similar to many of the popular spreadsheet programs available commercially. Choosing a command is as simple as pressing the right or left arrow keys on the numeric keypad to highlight the correct command. After the correct selection has been highlighted, execute the command by pressing the return key. An alternative means of executing a command is to simply press the key containing the first letter of the command. For example, pressing the "Q" key (Q = QUIT) when the main menu is showing will terminate TURBO SCREENWORKS and return control to the operating system. TURBO SCREENWORKS uses three menus to guide you through the process of creating screen images and preparing collated files. Two of the three menus are accessed from the topmost or MAIN menu, each of which are comprised of related commands. When in one of the two sub-menus, pressing the ESC key will return you to the MAIN menu. A diagram of the commands available in each menu is provided on the following page. ------------------------------------------- -7- + TURBO SCREENWORKS ------------------------------------------- | MAIN MENU --------- EDIT FILE MENU --------- | - LOAD FILE -------------------------->| COLLATE MENU | - SAVE ----------- | COLLATE -------->| | - MERGE | - OPEN | | | - ERASE HELP | - CLOSE | | | - RENAME | - ADD | NEW | | - DIR | - PREVIEW | | | - QUIT QUIT | - SOURCE | | - DIR | | - QUIT The function each command performs is described in the following pages under the appropriate section heading. ------------------------------------------- -8- + TURBO SCREENWORKS ------------------------------------------- | MAIN - EDIT The EDIT command places TURBO SCREENWORKS in the screen edit mode. It is in the screen edit mode that you can create new screens and modify existing screens that have previously been loaded from the disk (See FILE - LOAD and FILE - MERGE). Selecting the EDIT command removes the MAIN menu from the display. You can always tell when you are in the screen edit mode because cursor changes from a blinking underscore to a blinking box. When in the screen edit mode, the keyboard can be broken up into essentially six different functional groups, each of which performs different functions. Their descriptions and functions follows: CHARACTER KEYS ------------------------------------------- With the exception of several control characters (ASCII 7, 9-13 and 28-31), the entire character set is available for screen image design. Simply type whatever you want to appear on the screen as you would with any word processor. Characters not directly accessible from the keyboard can be printed on the screen image by entering its ASCII equivalent on the numeric keypad while depressing the ALT key. ------------------------------------------- -9- + TURBO SCREENWORKS ------------------------------------------- | CURSOR CONTROL ------------------------------------------- Up Arrow - Moves the cursor up one row Down Arrow - Moves the cursor down one row Left Arrow - Moves the cursor left one column Right Arrow - Moves the cursor right one column Home - Moves the cursor to the beginning of the current line End - Moves the cursor to the end of the current line PgUp - Moves the cursor to row 1, column 1 PgDn - moves the cursor to row 25, column 80 Tab - Moves the cursor right ten columns Shift Tab - Moves the cursor left ten columns NOTES: Cursor movement does not change foreground or background attributes. ATTRIBUTE KEYS ------------------------------------------ F3 - Select foreground color attribute. With color monitors, eight different colors can be selected. For monochrome monitors, pressing this key selects normal, reverse and underlined video. ------------------------------------------ -10- + TURBO SCREENWORKS ------------------------------------------- | F4 - Select background color attribute. With color monitors, eight different background colors can be selected. This key has no effect with monochrome monitors. Shift F3 - Intensity toggle. Key shift F3 toggles the high intensity attribute on and off. Shift F4 - Blink toggle. Key shift F4 toggles the blinking attribute on and off. NOTES: Changing attributes affects not only the current character highlighted by the cursor but all subsequently typed characters as well. If block markers are present, changing attributes affects the entire marked block. BLOCK ACTION KEYS ------------------------------------------- F5 - Block begin. This key marks the beginning or upper-left hand corner of a block. F6 - Block end. This key marks the end or lower right-hand corner of a block. Shift F5 - Remove block markers. Pressing these keys removes both block markers, if present. ------------------------------------------- -11- + TURBO SCREENWORKS ------------------------------------------- | F7 - Block copy. Pressing this key copies the marked block to the position beginning with the current cursor location. F8 - Block Move. This key moves the marked block from its current position to the new position indicated by the cursor location. F9 - Block delete. The marked block is deleted. NOTE: The computer sounds an error if block functions are invoked and a block has not been marked. If block markers are present, changes in attributes affects the entire block marked and not just the character highlighted by the cursor. CURSOR DRAW KEYS -------------------------------------------- SHIFT F7 - Single line cursor draw. Pressing the SHIFT and the F7 keys together activates the cursor draw mode. When activated, pressing any of the four directional cursor movement keys on the numeric keypad prints the appropriate single line block graphics character on the screen. To de-activate the cursor draw ------------------------------------------- -12- + TURBO SCREENWORKS ------------------------------------------- | mode, depress the SHIFT key and either the F7 or F8 key. SHIFT F7 - Double line cursor draw. This mode is identical to the single line cursor draw mode except that double line block graphics characters are used. NOTE: - When in the cursor draw mode, the cursor changes from a blinking box to a blinking dash. MISCELLANEOUS KEYS ------------------------------------------- F1 - Help. Help can be accessed anytime by pressing this key. F2 - Return to the MAIN menu. F10 - Replace key. This function is used to replace characters globally or within a block. To replace a character, position the cursor over the character you wish to replace and press F10 followed by the character you wish to replace it with. If block markers are present, all occurrences of the original character within the marked block are replaced with the new character. If block markers are not present, then substitution occurs globally i.e. across the entire screen image. ------------------------------------------- -13- + TURBO SCREENWORKS ------------------------------------------- | Shift F6 - Show cursor position. When the SHIFT key and key F6 have been pressed simultaneously, the coordinates (row,col) of the cursor position are displayed in the center of the display. Pressing any key will restore the screen image. Alt F9 - Clear screen. Pressing the F9 key while depressing the ALT key will clear the entire display. NOTE: TURBO SCREENWORKS will not ask for confirmation. ------------------------------------------- -14- + TURBO SCREENWORKS ------------------------------------------- | MAIN - FILE INVOKING the FILE command causes another menu to appear. The subset of commands found in the FILE menu relate to the storage of complete screen images or screen images under development on a disk. The screen image files accessed from this menu should not be confused with collated screen image files (See MAIN - COLLATE). You cannot load a collated screen file into TURBO SCREENWORKS from this menu. Screen image files accessed from this menu are those having extensions of .DTP and .DTA. Commands in the FILE menu are invoked in a manner identical to the MAIN menu. Press key F1 for on-line help with FILE menu commands. FILE menu functions available are: LOAD - Load a screen image. After selecting LOAD, TURBO SCREENWORKS will prompt you for the filename of the screen image file you wish to load. TURBO SCREENWORKS will display an error message if one or both of the disk files (FILENAME.DTP, FILENAME.DTA) cannot be found. If the file exists, the current screen image is erased and the new screen image is loaded. ------------------------------------------- -15- + TURBO SCREENWORKS ------------------------------------------- | After loading a screen image, the filename of the screen image you loaded will appear in the lower right-hand corner of the menu and control will return to the FILE menu. SAVE - Save a screen image. TURBO SCREENWORKS will prompt you for a filename of the screen image you wish to save. After entering a name, TURBO SCREENWORKS will create two files with extensions of '.DTP' and '.DTA.' If the files already exits, TURBO SCREENWORKS will write over the files with the new screen image. If a portion of the screen image has been blocked off using the block begin (F5) and block end (F6) keys, then only that portion of the screen image is saved to the disk file. Screen images saved with this command cannot be used by the FILLSCREEN command. Only collate files can be used by the FILLSCREEN command. MERGE - Merge a screen image. Merging a screen image is identical to loading a screen image except that the screen ------------------------------------------- -16- + TURBO SCREENWORKS ------------------------------------------- | image currently displayed will not be erased. Instead, the screen file specified is merged with or 'overlaid' onto the image currently displayed. Obviously, if the screen image to be merged occupied the entire display and not just a portion of it, then the screen image currently displayed will be overlaid entirely with the screen to be merged. If, on the other hand, the screen image to be merged consisted of a portion of the display (i.e. a FILE- SAVE command executed with block markers in place) then the image to be merged will overlay the corresponding portion of the current screen image. ERASE - Erase a screen image. After selecting ERASE, TURBO SCREENWORKS will prompt you for the filename of the screen image file to erase. If TURBO SCREENWORKS cannot locate either FILENAME.DTP or FILENAME.DTA, an error message will be issued. Otherwise, TURBO SCREENWORKS will erase both files associated with the screen image. ------------------------------------------- -17- + TURBO SCREENWORKS ------------------------------------------- | RENAME - Rename a screen image. RENAME does as the name implies - it permits you to rename an existing screen image file. TURBO SCREENWORKS will first prompt you for the filename of the screen image to rename. If TURBO SCREENWORKS cannot locate both files associated with a screen image (FILENAME.DTP and FILENAME.DTA), an error message is issued and control returns to the FILE menu. Otherwise, TURBO SCREENWORKS will prompt you for the new name of the screen image file, rename the files and return control to the FILE menu. DIR - Directory. Selecting DIR from the FILE menu lists the names of all screen image files residing in the current directory. Collate filenames are not listed with this command but can be obtained with the COLLATE-DIR command (See MAIN - COLLATE). QUIT - Quit the FILE menu. Selecting QUIT returns control to the MAIN menu. ------------------------------------------- -18- + TURBO SCREENWORKS ------------------------------------------- | MAIN - COLLATE Choosing the COLLATE command from the MAIN menu will replace the MAIN menu with COLLATE menu. COLLATE menu commands represent a set of functions that operate on collate files and not screen image files. COLLATE files contain one or more screen images and are accessed by the FILLSCREEN procedure in your pascal program(s). Screen image files represent individual screen images that, when complete, can be collected into collate files. Selecting COLLATE from the MAIN menu will erase the current screen image, if present, from the display. The screen image will be restored, however, when returning from the COLLATE menu to the MAIN menu. Press key F1 for on-line help with COLLATE commands. FILE menu functions available are: OPEN - Open a collate file. Selecting the OPEN command prepares a collate file for processing. TURBO SCREENWORKS will prompt you for the name of the collate file to be opened. If the file does not exist, one will be created with that name. If the file already exists, then the file will be opened and prepared for processing. ------------------------------------------- -19- + TURBO SCREENWORKS ------------------------------------------- | Screen images added to an already existing collate file are appended sequentially to the end of the file. Opening a collate file actually creates two temporary files that are merged into one file with an extension of '.SDT' after closing the file. Only one collate file may be open at a time. Opening a collate file automatically closes a collate file previously opened. CLOSE - Close a collate file. If a collate file has been previously been opened, choosing the CLOSE command will close the collate file and prevent further processing of that file. ADD - Add a screen image file. Selecting ADD causes TURBO SCREENWORKS to prompt you for the name of a screen image file that was created with TURBO SCREENWORKS and saved using the FILE-SAVE command. If TURBO SCREENWORKS cannot locate the file in the default directory, an error message will be issued. Otherwise the screen image file will be added to the collate file. ------------------------------------------- -20- + TURBO SCREENWORKS ------------------------------------------- | Screen image files are added sequentially to the collate file. The number of screen images that can be added to a collate file is dependant upon storage space available. A collate file must have previously been opened before screen images can be added. PREVIEW - Preview a collate file. The contents of an opened collate file can be viewed by selecting the PREVIEW command. After selecting PREVIEW, the first screen image in the collate file is loaded and displayed. You can preview the entire collate file by pressing either the left or right arrow keys located on the numeric keypad. Pressing the right arrow key will load and display the next screen image present in the file. Likewise, pressing the left arrow key will load and display the previous screen image. A collate file must have previously been opened in order to preview it. The loading and displaying of screen images from a collate ------------------------------------------- -21- + TURBO SCREENWORKS ------------------------------------------- | file using the PREVIEW command is much slower than with the FILLSCREEN procedure in your pascal programs. SOURCE - Source listing. The SOURCE command generates a pascal source file on your disk that contains the FILLSCREEN procedure for incorporation into your pascal program(s). TURBO SCREENWORKS will prompt you for the name of the source file and append a '.INC' extension to it. DIR - Directory. Selecting DIR from the FILE menu lists the names of all collate files residing in the current directory. Screen image filenames are not listed (See MAIN - FILE). ------------------------------------------- -22- + TURBO SCREENWORKS ------------------------------------------- | MAIN - HELP The HELP command provides on-line information about TURBO SCREENWORKS and how to use the software. The help text is stored in a disk file that can be accessed at any time while using TURBO SCREENWORKS. Help can be obtained by either selecting HELP from the MAIN menu or by pressing function key F1. The help text file, SCRNWRKS.HLP, must reside in the default directory. If TURBO SCREENWORKS cannot locate the file, an error message will be issued. For your information, the TURBO SCREENWORKS help screens were designed and collated using TURBO SCREENWORKS. ------------------------------------------- -23- + TURBO SCREENWORKS ------------------------------------------- | MAIN - NEW The NEW command simply erases the current screen image from the display and from memory. TURBO SCREENWORKS will ask you to confirm the request before actually erasing the image. ------------------------------------------- -24- + TURBO SCREENWORKS ------------------------------------------- | MAIN - QUIT Selecting QUIT from the MAIN menu returns you to the operating system. TURBO SCREENWORKS will first ask you confirm the command. ------------------------------------------- -25- + TURBO SCREENWORKS ------------------------------------------- | USING FILLSCREEN After designing, creating and collating screen images, the next step required is to incorporate the screen management procedure into your pascal program. After you have created a collate file, simply execute the COLLATE-SOURCE command. Executing the COLLATE-SOURCE command will: - create a pascal source code file containing the FILLSCREEN procedure. An extension of '.INC' is appended to the name you provide. - incorporate the name of the collate file currently open into the FILLSCREEN procedure. Thus, to use the FILLSCREEN procedure, all you need to know are what parameters must be passed when calling the procedure. Once the source code file has been produced it can be included into your source code either by merging it directly into the procedure declaration part of the program or by using the INCLUDE compiler directive. To use the INCLUDE compiler directive, simply insert the line {$I FILENAME.inc} into your pascal program's procedure declaration block, where FILENAME is the name you supplied when executing the COLLATE-SOURCE command. At compile time, the compiler will automatically load and compile the FILLSCREEN procedure with the rest of your source code. ------------------------------------------- -26- + TURBO SCREENWORKS ------------------------------------------- | Accessing the various screen images contained in the collate file requires the use of the FILLSCREEN procedure. The FILLSCREEN procedure requires the following syntax when called: procedure FILLSCREEN(SCRN_NO:integer; ACTION:byte; OVER_LAY:boolean; var IOERR:integer); where SCRN_NO = an integer expression that defines the position of the screen image in the collate file. This number can be obtained by using the COLLATE-PREVIEW command. This expression has no effect with an ACTION of 4 or 5. ACTION = a byte expression from 1 to 5 that indicates what action is to be taken: 1 Read the screen image from disk into DISPLAY memory and into V_DATA 2 Read the screen image from disk into V_DATA only 3 Read the screen image from disk into DISPLAY memory only 4 Move the screen image data contained in V_DATA to DISPLAY memory. SCRN_NO has no effect with this ACTION. 5 Move the screen image data ------------------------------------------- -27- + TURBO SCREENWORKS ------------------------------------------- | contained in DISPLAY memory to V_DATA. SCRN_NO has no effect with this ACTION. OVERLAY = a boolean expression that indicates whether the screen image to be read from disk is overlaid on top of the current screen image. This parameter has no effect if the ACTION is equal to 4 or 5. TRUE = Overlay the new image on top of the current image. FALSE Erase the current image before reading the new screen image IOERR = an integer expression that is returned by FILLSCREEN that indicates the success of the operation. The code and meanings returned are identical to those returned by IORESULT (consult your Turbo Pascal manual). An expression of 0 is always returned when an ACTION of 4 or 5 is used since neither preforms any disk I/O operations. The effective use of FILLSCREEN requires an understanding of how the procedure manipulates two areas of memory in your computer that we will call DISPLAY and V_DATA memory. DISPLAY memory is that actual chunk of linear memory used by your computer to hold the attribute and character bytes displayed on your monitor. ------------------------------------------- -28- + TURBO SCREENWORKS ------------------------------------------- | V_DATA memory is simply another linear chunk of memory that is used by FILLSCREEN. V_DATA memory is organized in a manner identical to DISPLAY memory but is not visable on your display monitor. V_DATA is used simply as a storage buffer by FILLSCREEN for screen I/O operations. When calling FILLSCREEN, the ACTION parameter determines on which chunk of memory the operation is to act upon. For example, setting ACTION equal to 1 instructs FILLSCREEN to load an image from the disk-based collate file into both DISPLAY memory and V_DATA memory. Thus, if no other calls to FILLSCREEN have been made, V_DATA memory is identical to DISPLAY memory and you will see the image displayed on your monitor. On the other hand, if ACTION is set equal to 2, the screen image loaded from the collate file is placed only into V_DATA memory and not into DISPLAY memory. As a result, only V_DATA memory contains the image just loaded -- DISPLAY memory has not changed. The following example will show how FILLSCREEN can be used to overlay "help screens" onto the currently displayed screen image and restore the original screen image when done. ------------------------------------------- -29- + TURBO SCREENWORKS ------------------------------------------- | First, save the current image to V_DATA SCRN_NO := 0; ACTION := 5; OVERLAY := false; IOERR := 0; fillscreen(SCRN_NO,ACTION,OVERLAY,IOERR); NOTE: Because an ACTION of 5 was selected, the expressions SCRN_NO, OVERLAY and IOERR are meaningless. Next, load a page of help text into DISPLAY memory only SCRN_NO := 1 { 1st page of help } ACTION := 3 OVERLAY := true; IOERR := 0; NOTE: The first page of help text is loaded into DISPLAY memory only. Thus, the operator actually sees the help text. However, since the help text was loaded into DISPLAY memory only, the original screen image is still retained unmodified in V_DATA. If multiple pages of help text are available, your program should continue to read each page of help text into display memory ONLY. When the operator has signaled that help is no longer needed, your program should copy the original image from V_DATA memory back into DISPLAY memory with the statement ------------------------------------------- -30- + TURBO SCREENWORKS ------------------------------------------- | SCRN_NO := 0; ACTION := 4; OVERLAY := false; IOERR := 0; fillscreen(SCRN_NO,ACTION,OVERLAY,IOERR); NOTE: This time, an ACTION of 4 was selected which copies the data contained in V_DATA memory to DISPLAY memory. Thus, the original screen image displayed before "HELP" was invoked is restored. The effective use of FILLSCREEN requires both an understanding of how the procedure works and careful planning of program flow and execution. TURBO SCREENWORKS was built using the same system. ------------------------------------------- -31- + TURBO SCREENWORKS ------------------------------------------- | QUICK KEY EDIT GUIDE CURSOR CONTROL ------------------------------------------- Up Arrow - Moves the cursor up one row Down Arrow - Moves the cursor down one row Left Arrow - Moves the cursor left one column Right Arrow - Moves the cursor right one column Home - Moves the cursor to the beginning of the current line End - Moves the cursor to the end of the current line PgUp - Moves the cursor to row 1, column 1 PgDn - moves the cursor to row 25, column 80 Tab - Moves the cursor right ten columns Shift Tab - Moves the cursor left ten columns ATTRIBUTE KEYS ------------------------------------------- F3 - Select foreground color F4 - Select background color Shift F3 - Intensity toggle. Shift F4 - Blink toggle. ------------------------------------------ -32- + TURBO SCREENWORKS ------------------------------------------- | BLOCK ACTION KEYS ------------------------------------------- F5 - Block begin. F6 - Block end. Shift F5 - Remove block markers. F7 - Block copy. F8 - Block Move. F9 - Block delete. CURSOR DRAW KEYS ------------------------------------------- SHIFT F7 - Single line cursor draw. SHIFT F7 - Double line cursor draw. MISCELLANEOUS KEYS ------------------------------------------- F1 - Help. F2 - Return to the MAIN menu. F10 - Replace key. Shift F6 - Show cursor position. Alt F9 - Clear screen. ------------------------------------------- -33- +